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FOREWORD 


In order to Improve technical and management communication within the Foreign 
Commodity Production Forecasting (FCPF Project with other AgRISTARS projects 
and program management, It has become necessary to establish some conventions 
and standards for reporting on remote sensing technical analysis procedures 
development and testing. 

This document establishes those standards ard conventions to be used in FCPF 
communications/documentations for Identifying and describing remote sensing 
technical analysis procedures and reporting of test results to AgRISTARS 
project and program management. 

This FCPF Standards Manual will be periodically updated on a scheduled (every 
3 months) basis. The related FCPF Test Reports Document will also be published 
on a scheduled basis but on a 6-month cycle and will present all test results 
which occurred during this period. 
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1 . INTRODUCTION 


1.1 BACKGROUND 

The AgRISTARS Foreign Cownodity Production Forecasting (FCPF) Project's 
developmental activities are producing a nimber of different analysis 
procedures. Some of these software procedures are new analytical concepts 
while others are derivatives of older procedures. As testing on these 
analytical variants proceed, it has become apparent that a standard 
system of identification and documentation of the analytical procedures 
is required as well as some documentation conventions relative to 
the reprinting of developmental and evaluation test results. 

1.2 OBJECTIVES 

The purpose of this document is to: (a) establish standard working terminology 

for technical project and programmatic communications among and between 
FCPF Project technologists and managers as well as with other AgRISTARS 
projects and program management, (b) provide basic reference material for 
FCPF project technologists, and (c) provide introductory training material 
for new FCPF technical personnel. 
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2. APPROACH 


This FCPF Standards Document will present communl cations/documentation 
guidelines organized Into the following two sections: 

0 Procedural Docun^ntatlon 

0 Test/Experin.ent Reporting Documentation 

Within these sections, the required standard documentation elements are 
Identified and discussed. Figure 1 contains a simmary emmeratlon and 
description of these elements. Standard formats and related coding 
requirements and guidelines are presented In the following sections. 

Also being published separately at this time are the FCPF Standards Procedural 
documentation of all the current FCPF remote sensing analytical procedures. 
This procedural documentation Is Included In the FCPF Procedures Designation 
and Description Document, Volime I, dated June 1981. 

In addition, the Initial publication of the FCPF Test Reports Document, 

Volume I, date June 1981 Is being released which Includes the first three 
test reports to be published In accordance with the FCPF Communication/ 
Documentations Standards. 
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3. REHOTE SENSING ANALYSIS PROCEDURES COMMUNICATION/OOCUMENTATION STANDARDS 


The purpose of the Procedures Section of the FCPF Conmunl cation/ 
Documentation Standards Is to: 

0 Establish a procedural systems structure and define the 
functional levels of remote sensing software and FCPF 
technologies In the context of agricultural Information systems. 

0 Define a coding system for designation of agricultural 
remote sensing analytical procedures. 

0 Establish a system of describing the analytical 
procedures . 

0 Provide guidelines for the documentation of tne relationship 
of the procedure to previous procedures. 

0 Provide standard formats for presentation of procedural 
documentation. 

3.1 FCPF PROCEDURAL SYSTEMS STRUCTURE 

The categorization of the remote sensing agricultural Information system 
Into function levels provides a reference context for project and program 
conmunlcatlons/documentatlon and provides a framework for technical 
discussions and test reporting. 

Figure 2 presents definitions and examples of the function levels or 
building blocks of the remote sensing agricultural information system. 

Another "Illustration" or diagram describing the Interrelationships between 
the various functional levels and also Identifying the various types 
(component level) of procedures used In the system. Is presented In 
Figure 3. Another diagram of an alternate configuration of this Remote 
Sensing Agricultural Information System Is presented in Figure 3A to 
illustrate that there are other potential configurations of this system. 
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3.2 STANDARD HEADING FOR PWOCEDURAL DOCUMENTATION 

There are a number of Informational Items that are of significance and 
should be referenmd In all procedural documentation. This "headef" 
type Information can be categorized ami efficiently presented If 
a standard heading Is used In all such documentation. To simplify 
this process, a standard FCPF heading format has been created and Is 
presented In Figure 4 along with guidelines for completing this 
heading Information. 

3.3 CRITERIA FOR PROCEDURES DESIGNATION 

The criteria to be used In designation of procedures Is: 

0 Minor developmental variations In a Procedure will be 

designated as a variant and given a modifying letter designator 
(e.g., SS6-1 A . What constitutes a minor variation maybe 
quite different from procedure to procedure, but In essence 
1t means that the basic structure of the procedure has rot 
been altered but only a minor modification has been made. 

However, It Is in^ortant that miror modifications are Identified. 

0 Major developmental changes In a procedure or the development of a 
new analytical procedure will be given new numerical designators 
(e.g.. If SSG'IA Is the last developmental variant, then 
the new procedure would be designated SS6-2). 

3.4 STANDARD FORMATS FOR PROCEDURAL DOCUMENTATION 

In Figure 1. five elements of Procedural Documentation were identified. 

The first Is the updated Procedural Development Family Tree. This 
standard graphics format Identifies the procedure (Procedure Code/Procedure 
Name) and depicts It on a vertical graph representing time and technology 
development. Figure 5 contains a completed guideline example of this procedural 
document. Its purpose Is to provide a s1itq)11f1ed graphical depiction 
of the deviation of current procedures and their relationship to past 
pro'tdures. Direct and Indirect relationships to parent procedures 
should be shown. The other four documentation elements are correlated. 
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Thtir purpose Is to give a summary overvIrM of the procedural content and 
to provicte a pointer or reference to laore detailed documentation of the 
procedure. 

A guideline example of the four procedural formats Is presented In 
Figure 7 (Sheets 1, 2, 3, 4). The Procedural Summary Sheet's purpose Is 
to provide somewhat of an executive summary of the procedures. Nmnely, 
to provide a rationale a: to why the procedure was developed. Its 
relationship to past procedures, some general Information on data 
requirement such as the number of acquisitions required during a 
growing season in order to process the se^nent with the procedure, etc. 

What [Mrformance Information on the procedure has been acquired to 
date should also be provided. 

Sheets 2 and 3 are the summary technical descriptions of the remote 
sensing analytical procedure. Both sheets utilize the standard procedures 
heading form. The guidelines for completing the heading are presented In 
Figure 4, and the guidelines for development of the function flow diagrams 
are presented In Figure 6. Also provided In this Illustration Is an 
example of a functional grouping heading. (This one Is for Area Estimation.) 
This heading provides a mechanism for standardizing the segmentation of 
t1» procedure function flows Into the significant parts. This standard 
heading groups Is an Important aspect of these diagrams. By having a 
common structural arrangement for a type of procedure (e.g., Area 
Estimation, Smnpling, Aggregation, Crop Calendars, Yield, Data, etc.). It 
allows a quick general comparison to be made between different procedures 
and of the manner In which particular functional groups of procedures 
are accomplished. This function grouping heading will be different for 
the different types of procedures. (For example, sampling procedures 
will be different, aggregation procedures will be different, etc.) 
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The functions or actiwis required by the procedures ere numbered on the 
flow chert. The rationale for this requirement Is to provide an easy 
mechanism for referencing the Individual steps If they are to be 
referred to or discussed. Also, these numbers serve as the basic 
reference for the verbal descriptions of each function that are 
Included on the Procedural Function description chart, (Figure 7, Sheet 2). 

One of the objectives of the FCPF Communication/Documentation Standards 
Is to serve as a training and familiarization document. It Is with this 
In mind that the procedural documentation requires that a reference to the 
detailed documentation of a procedure be provided. (Figure 7 (Sheet 4) 

Is a guideline example of the standard format to be used for this docunent action. 
This form requires that technical and software references be provided along with 
Identification of the technical consultant for the procedure. 

Copies of t^'ese standard forms will be made available to FCPF 
technologists to assist them in providing the standard "Information” 
on procedural development. 


4 . TEST REP0RTIN6 COMMUNICATIONS/DOCUMENTATICKI CONVENTIONS 


Previous FCPF test reporting documentation has suffered from not always 
covering all aspects and/or Information that Is necessary to provide a basis 
for project presentation to hlgl^r AgRISTARS managawnt levels, other 
AgRISTARS projects and government ageiKles requesting Information on 
FCPF project accomplishments. As a result, test results presentation 
have been more lengthy and not as thorough as desirable. Queries from 
Project Managers have been required to get Information and no penn«:..int 
file of test results have been maintained. This has led to many redundant 
documentation burdens upon technical and management personnel. 

The purpose of defining conventions for Test Reporting Com-nunl cations/ 
Docimientatlon standards Is to provide definitive guidelines as to the type 
of Information required and In a form that will simplify the preparation 
of the test reporting documentation and will elemlnate much of the 
redundancy In the test reporting process. 

4.1 STANDARD HEADING AND FORMATS FOR TEST REPORT DOCUMENTATION 

Test Reporting Documentation will be prepared and presented on standard 
formats that will be suitable for viewgraph presentations as well as 
for documentation requirements. 

The basic elements of the Test/Experiment Reporting Doc ntatlon are 
summarized In Figure 1. They Include Test Description, Frocedural 
Documentation, Data Set Description, Test Results, Procedures Efficiency 
Data, and Results Evaluations/Recommendations. 

All of these data will be presented with standard test documentation 
hea<ter Information. Figure 8 presents guidelines for the completion 
of this header requested information. With this header Information, the 
Test Report Is put in the context of the test sultatlon. 


Figure 9 (Sheets 1 through 5) contains the five basic formats to be used 
In Test Reporting. Requiring the use of these forms Is not Intended 
to restrict the creative presentation of data and If after completing 
the Initial sheet 4 (Test Results), other data may be presented using 
full sized pages. If required, to effectively present the test results. 

In addition to the Test Reporting Sheets, Procedural documentation In 
the form specified In Section 1 Is presented to clarify and describe the 
procedure being tested. The map of test segment locations locates the data 
used In the test and on (Sheet 3) provides the rationale for data set 
selection and further discussion of the data set if required. Examples 
of completed Test Reports (1, 2, and 3 are provided in Appendix B as 
further guideline examples of the conventions to be used in Test 
Reporting. 
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Figure 2. Functional Levels or Building Blocks of 
Remote Sensing Agricultural Information 
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ower Subcomponent 

evel — n ~~ n ► 0 A unique integrated network of functional elements/algorithms 

‘ which constitute a subassemblage of the component (Example - 

Labeling Subcomponent of Area Estimation). 
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Figure 3,— A represantatitf* remoti santing agricultural « 
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Figur* 3A.- An ahsmate ramote sensing agricultural information system configuration. 
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PROCEDURE • SUMMARY DESCRIPTION 


Procedure type 

Procedure code 

Procedure name 

Level 

AREA ESTIMATION 



SUBSYSTEM 


• Purpose/rationale; 

—Indicate why procedure was created. 

Examples: o To Improve labeling functions. 


0 To address a specific problem with a particular procedure. 

0 To make a particular procedure more efficient with respect to 
0 To develop an alternative technology. 


• Kelattonship to past pfocedures: 

—Indicate to which parent procedure this procedure Is 

Example: - This procedure Is derived from 

or 

This is a new procedure. 

—Indicate what Improvenents have been incorporated Into this procedure. 

Example— Improved a particular function. 

--Increased the efficiency. 



• Uat<i/fetource fequlrements; 

—Crop Calendar data function is satisifed by a 

—Daily met (temp) from standard operational network required to support acquisition 
select 

— Landsat digital and film products required from a minimum of acquisitions/ 

segment during Early. Mid, Late season. 

—Approximate manual operations time per segment . 

—Approximate CPU operations time per segment . 


• Summary of performance to date; 
Summarize test results to date. 


Figure 7 (Sheet 1 ) 
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REFERENCES TO DETALED TECHMCAL PROCEDURES DOCUMENTATION 

Proccdurs type 

Procerhire code 

Procedure name 

Level 

AREA EST. 

SSG-4 

SPATIAL/COLOR SEQ. 

SUBSYSTEM 

Kef. 

number 

TITLt 

Technical description of documentation 

1. 

TECHNICAL REPORT — Interpretation of Landsat digital data using a cubic 
color model based on relative energies. Cate et a1.. AgRISTARS SR-LO-00418, 
JSC-13776, Feb. 1980. 

2. 

Spatlal/Color Sequence Proportion Estimation Techniques. T. 6. Dennis, 
AgRISTARS SR-LO-04028, JSC-16848, Dec. 1980. 

Software documentation 

3. 

As Built Design Specification (In revIcM) 




'S 

05^ 


Procedural con>ultant(s) 


R. B. Cate 
T. B. Dennis 
« 




• 


5-10 




























































FIGURE 9 (SHEET 2) 






DATA SET DISCUSSION 



FIGURE 9 (SHEET 3) 
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